Back to the Login view | Onward to the Message view | Up to Working with Views
The mailbox view is perhaps the most complicated of all the views. It has its own special command that can appear in the URL (listfrom) and quite a few tags. Mailbox View
The most important tag is the [mailbox]...[/mailbox] block. It is processed once for each message that will be displayed. Within that block, there are several tags that can be used to display parts of the message header. The most important are [subject] and [msgno], which output the message's subject line and message number, respectively.
The listfrom And maxmsgs Commands
The listfrom command is very important for allowing the user to traverse the mailbox. This command can appear in any URL that references mailbox.remotemail. It adjusts the message pointer, which determines which message will be displayed first in the mailbox. The listfrom command's value can be in any of these forms:
- listfrom=top
- Sets the pointer to the first message. On most servers this is the oldest message.
- listfrom=bottom
- Sets the pointer to display the last messages. On most servers these are the most recent messages.
- listfrom=fnumber
- Moves the pointer forward the indicated number of messages. If no number is given, then the pointer is moved maxmsgs messages. E.g., listfrom=f20 will put the mailbox forward 20 messages. Any attempt to move past the end of the mailbox will result in an "End of messages" error.
- listfrom=rnumber
- Rewinds the pointer the indicated number of messages. If no number is given, the maxmsgs value is used.
- listfrom=number
- Sets the pointer to the indicated message.
The maxmsgs command determines how many messages will be displayed in the mailbox. If the maxmsgs command is missing, then the configuration value for default-mailbox-length is used. The command takes the form of "maxmsgs=number". This value can be retrieved with the [maxmsgs] tag, which allows you to "carry forward" a non-default value from one mailbox screen to the next.
Supported Tags
- [xid]
- [maxmsgs] The max number of messages to display in the mailbox
- [mailbox]...[/mailbox] The contents are repeated once for each message to be displayed. Inside this block, the following tags are accepted:
- [msgno] - the message number
- [subject] - the message subject
- [sender] - the sender of the message
- [date] - the date the message was sent
More Net.Dreams Software